package com.yilizhiyou.service;

import com.yilizhiyou.entity.ScenicSpot;
import org.springframework.stereotype.Service;

import java.util.List;
import java.util.Map;

/**
 * AI搜索服务接口
 * 集成DeepSeek API进行智能搜索
 * 
 * @author 伊犁智游开发团队
 * @since 1.0.0
 */
public interface AiSearchService {

    /**
     * AI智能搜索
     * 
     * @param query 搜索查询
     * @param context 上下文信息
     * @return 搜索结果
     */
    Map<String, Object> aiSearch(String query, String context);

    /**
     * 获取搜索建议
     * 
     * @param partialQuery 部分查询
     * @return 搜索建议列表
     */
    List<String> getSearchSuggestions(String partialQuery);

    /**
     * 智能景点推荐
     * 
     * @param query 用户查询
     * @param allSpots 所有景点
     * @return 推荐的景点列表
     */
    List<ScenicSpot> intelligentSpotRecommendation(String query, List<ScenicSpot> allSpots);

    /**
     * 语义搜索
     * 
     * @param query 自然语言查询
     * @param allSpots 所有景点
     * @return 匹配的景点列表
     */
    List<ScenicSpot> semanticSearch(String query, List<ScenicSpot> allSpots);

    /**
     * 生成搜索摘要
     * 
     * @param query 搜索查询
     * @param results 搜索结果
     * @return 搜索摘要
     */
    String generateSearchSummary(String query, List<ScenicSpot> results);
}
